<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>GEN31</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="ScoregensTop.html" title="Score Statements and GEN Routines" />
    <link rel="prev" href="GEN30.html" title="GEN30" />
    <link rel="next" href="GEN32.html" title="GEN32" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">GEN31</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="GEN30.html">Prev</a> </td>
          <th width="60%" align="center">Score Statements and GEN Routines</th>
          <td width="20%" align="right"> <a accesskey="n" href="GEN32.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="GEN31"></a>
      <div class="titlepage"></div>
      <a id="IndexGEN31" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">GEN31</span>
        </h2>
        <p>GEN31 — 
      Mixes any waveform specified in an existing table.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp215412032"></a>
        <h2>Description</h2>
        <p>
      This routine is similar to <a class="link" href="GEN09.html" title="GEN09">GEN09</a>, but allows mixing any waveform specified in an existing table.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp215476000"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>f</strong></span> # time size  31  src  pna stra phsa  pnb strb phsb  ...</pre>
      </div>
      <div class="refsect1">
        <a id="idp215478064"></a>
        <h2>Performance</h2>
        <p>
      <span class="emphasis"><em>src</em></span> -- source table number
    </p>
        <p>
      <span class="emphasis"><em>pna, pnb, ...</em></span> -- partial number, must be a positive integer
    </p>
        <p>
      <span class="emphasis"><em>stra, strb, ...</em></span> -- amplitude scale
    </p>
        <p>
      <span class="emphasis"><em>phsa, phsb, ...</em></span> -- start phase (0 to 1)
    </p>
        <p>
      <span class="emphasis"><em>GEN31</em></span> does not support tables with an extended guard point (ie. table size = power of two + 1). Although such tables will work both for input and output, when reading source table(s), the guard point is ignored, and when writing the output table, guard point is simply copied from the first sample (table index = 0).
    </p>
        <p>
      The reason of this limitation is that <span class="emphasis"><em>GEN31</em></span> uses FFT, which requires power of two table size.  <a class="link" href="GEN32.html" title="GEN32"><em class="citetitle">GEN32</em></a> allows using linear interpolation for resampling and phase shifting, which makes it possible to use any table size (however, for partials calculated with FFT, the power of two limitation still exists).
    </p>
      </div>
      <div class="refsect1">
        <a id="idp215485408"></a>
        <h2>Credits</h2>
        <p>Author: Istvan Varga</p>
        <p>New in version 4.15</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="GEN30.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="ScoregensTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="GEN32.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">GEN30 </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> GEN32</td>
        </tr>
      </table>
    </div>
  </body>
</html>
